home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / onlypc / linux / a.out / install < prev    next >
Text File  |  1995-08-12  |  9KB  |  205 lines
  1. Installation instructions for XFree86[TM] 3.1.2 Linux distribution [7/23/95]
  2. ----------------------------------------------------------------------------
  3.  
  4. Introduction
  5. ------------
  6.     This is the Linux binary distribution of XFree86 release 3.1.2.
  7. Please read this document carefully before installation, and the included
  8. doc package for detailed configuration information.
  9.  
  10.     An ELF version of this distribution is now available. Instructions
  11. for using the ELF distribution is provided below.
  12.  
  13. Requirements
  14. ------------
  15.     (If using the a.out distribution)
  16.     Linux 1.0, 1.2, or later
  17.     libc-4.5.26, or newer
  18.     libm-4.5.26, or newer
  19.     ld.so-1.4.3, or newer
  20.     shadow-3.3.2 (if using xdm-shdw)
  21.  
  22.     (If using the ELF distribution)
  23.     Linux 1.2, or later
  24.     libc-5.0.9, or newer
  25.     libm-5.0.0, or newer
  26.     ld.so-1.6.6, or newer
  27.     shadow-3.3.2 (if using xdm-shdw)
  28.  
  29.     This distribution was tested using Linux 1.2.1 and should work
  30. without problems on all versions 1.0, 1.2, and later. Kernel networking
  31. support is required, although each server will work without TCP support
  32. (using the "partial network" option). In order to use the XShm extension,
  33. kernel shared memory support is required. All serial and bus mice detected
  34. by the kernel are supported by the servers.
  35.  
  36. Contents
  37. --------
  38.     Both a.out and ELF distributions are composed of the following parts:
  39.  
  40.            name        req/opt description
  41.           X3128514.tgz      R[1]    Server for 8514-based boards.
  42.           X312AGX.tgz      R[1]    Server for AGX-based boards.
  43.           X312Ma32.tgz      R[1]    Server for Mach32-based boards.
  44.           X312Ma64.tgz      R[1]    Server for Mach64-based boards.
  45.           X312Ma8.tgz      R[1]    Server for Mach8-based boards.
  46.           X312Mono.tgz      R[1]    Server for monochrome video modes.
  47.           X312P9K.tgz      R[1]    Server for P9000-based boards.
  48.           X312S3.tgz      R[1]    Server for S3-based boards.
  49.           X312SVGA.tgz      R[1]    Server for Super VGA-based boards.
  50.           X312VGA.tgz      R[1]    Server for VGA/EGA-based boards.
  51.           X312W32.tgz      R[1]    Server for ET4000/W32-based boards.
  52.           X312bin.tgz      R    The rest of the X11R6 binaries.
  53.           X312cfg.tgz      R    Configuration files.
  54.           X312doc.tgz      R    XFree86 documentation and manpages.
  55.           X312fnt.tgz      R    Basic fonts.
  56.           X312inc.tgz      R    Include files.
  57.           X312lib.tgz      R    Shared X libraries and support files.
  58.  
  59.           X312ctrb.tgz      O    Selected contrib programs.
  60.           X312f100.tgz      O    100-dpi screen fonts.
  61.           X312f75.tgz      O    75-dpi screen fonts.
  62.           X312fbig.tgz      O    Large Kanji and other fonts.
  63.           X312fscl.tgz      O    Scaled fonts (Speedo, Type1).
  64.           X312fcyr.tgz      O    Cyrillic fonts.
  65.           X312jdoc.tgz      O    Japanese version of some docs.
  66.           X312lkit.tgz      O[2]    Server linkkit for customization.
  67.           X312man.tgz      O    Manual pages.
  68.           X312pex.tgz      O    PEX binaries, includes and libraries.
  69.           X312slib.tgz      O    Static X libraries and support files.
  70.           X312ubin.tgz      O[3]    Daemons which reside in /usr/bin.
  71.           X312xdms.tgz      O    Shadow password version of xdm.
  72.           X312xtra.tgz      O    Extra XFree86 servers and binaries.
  73.  
  74.       X312alib.tgz      O[4]  A.out shared libs for the ELF distribution.
  75.       X312aslb.tgz      O[4]  A.out static libs for the ELF distribution.
  76.  
  77.     R = Required for basic operation.
  78.     O = Optional.
  79.     1 = Select server required for your board. If you're unsure which
  80.         server to choose, run SuperProbe (in the bin package).
  81.     2 = Use the linkkit to create a server with PEX and/or XIE support.
  82.     3 = Includes rstartd, for the rstart client. Must be installed in /.
  83.     4 = Required for backward a.out compatibility.
  84.  
  85. A.out or ELF?
  86. -------------
  87.     The traditional format of Linux executables and libraries is known
  88. as a.out (the shared libraries are still a.out, although they are also
  89. known as DLL libraries). ELF is a newer format which is much easier to use
  90. and program with, and is standard on many other Unixes. Because of this,
  91. ELF is expected to quickly overtake a.out as the default Linux format.
  92.  
  93.     However, as ELF support is still maturing, the Linux distributions
  94. of XFree86 provide both a.out and ELF versions. The ELF version contains
  95. portions of the a.out libraries so current binaries will run. In addition
  96. the a.out programming libraries are also provided, so external libraries
  97. can continue to be used.
  98.  
  99. Installation
  100. ------------
  101.     The distribution was compiled to reside in /usr/X11R6. The entire
  102. installation takes up about 42Mb. A "normal" installation takes up about 15Mb.
  103. The names of each tarfile has been created to fit onto filesystems with 8.3
  104. filename requirements, but this is not true of the contents.
  105.  
  106.     The installation must be done as root as there are binaries which
  107. must be unpacked setuid-root. Note that setuid-root operation is not required
  108. when using xdm. Each package is tarred up relative to /usr/X11R6 rather than /,
  109. so it's possible to unpack the distribution on another partition and make a
  110. symlink from there to /usr/X11R6.
  111.  
  112.     Each tarfile has been compressed using gzip, so the command
  113. `gunzip < {xxx.tgz} | tar xfBp -' will decompress and untar the file.
  114. At the very least, you will have to unpack all of the required
  115. packages described above. The optional packages can be unpacked now or
  116. later. Note that some toplevel directories will be created with 0777
  117. permissions. This can be fixed by running the following:
  118.     chmod 755 `find /usr/X11R6 -type d -perm 777`
  119.  
  120.     The next step is to configure the server. First, make sure the
  121. symbolic link /usr/X11R6/bin/X points to the correct server. As mentioned
  122. above, if you're unsure about which server to select, run the SuperProbe
  123. program (in /usr/X11R6/bin) which should give you that information.
  124.  
  125.     Then, you have to create a configuration file XF86Config, found in
  126. /usr/X11R6/lib/X11. The distribution provides a sample XF86Config.eg,
  127. which can be used as a starting point. The program xf86config can be
  128. used to generate an XF86Config file in an interactive fashion. If upgrading
  129. from XFree86 2.1, the old Xconfig can be turned into an XF86Config using
  130. the reconfig program, available in the bin package. The new format has been
  131. extensively improved, so read the XF86Config manpages and all documentation
  132. regarding your server. The xvidtune program can prove useful in tuning
  133. video modes for the server.
  134.  
  135.     The X libraries use the dynamic linker, ld.so, which must be
  136. installed. Make sure that /usr/X11R6/lib is one of the entries in
  137. /etc/ld.so.conf, or add it to your LD_LIBRARY_PATH environment variable.
  138. After installing, run ldconfig to update the system with the location of
  139. the new X libraries.
  140.  
  141.     Finally, add /usr/X11R6/bin to your PATH, before the entry for
  142. /usr/X386, if you have one, and add/usr/X11R6/man to your MANPATH.
  143. The command `startx' can be used to start the server and any clients.
  144. Xdm is also available for remote and local logins to the X server.
  145. A shadow-password compatible version of xdm is available, though it
  146. hasn't been tested. Further information on these programs is
  147. available in the manpages.
  148.  
  149. ELF Installation
  150. ----------------
  151.     The ELF distribution is designed to supplant the a.out distribution.
  152. This means that all ELF binaries and libraries can be found in the same
  153. location as their a.out counterparts. The downside is that a bit of special
  154. care is required to support both ELF and a.out on the same system.
  155.  
  156.     We use a similar strategy as employed by the ELF distribution of GCC.
  157. The /usr/X11R6/lib/i486-linuxaout directory contains the a.out shared and
  158. static libraries. To use them, add /usr/X11R6/lib/i486-linuxaout to
  159. /etc/ld.so.conf and run ldconfig.
  160.  
  161.     To minimize the effects of upgrading to ELF, the a.out shared library
  162. stubs (.sa) have been installed in /usr/X11R6/lib. This way one can run the
  163. ELF XFree86 distribution yet still compile with external a.out libraries
  164. mostly without makefile modification.
  165.  
  166. Configuration
  167. -------------
  168.     The precompiled servers were compiled with LBX and ScreenSaver
  169. extensions included, but without PEX or XIE extensions. The linkkit is
  170. provided with all extensions.
  171.  
  172.     All servers have been compiled with all available drivers. Smaller
  173. servers can be generated by selecting minimal options via the linkkit.
  174. The VGA16 and Mono servers were not compiled with dual-head support, but
  175. this option is also available through the linkkit.
  176.  
  177. Compatibility
  178. -------------
  179.     X11R6 is presented as a complete upgrade from X11R5. In particular,
  180. this means that X11R6 shared libraries cannot be used in place of the
  181. X11R5 (old X386) libraries. The major number has been upgraded on all
  182. the shared libraries to reflect this fact.
  183.  
  184.     In order to use old binaries, you must retain the X11R5 libraries.
  185. They can either remain in /usr/X386/lib or you can move them to some other
  186. location, remembering to update the ld.so config file /etc/ld.so.conf and
  187. re-running ldconfig. Old binaries should be compatible with the new X11R6
  188. server.
  189.  
  190.     For instructions about using the ELF distribution with a.out
  191. compatibility, see the ELF Installation instructions above.
  192.  
  193. Sources
  194. -------
  195.     Sources relative to X11R6 PL11 are available from ftp.XFree86.org
  196. under /pub/XFree86/current. The main README provided in the distribution
  197. has detailed information about mirror sites and XFree86 in general.
  198.  
  199.  
  200.     Please report all errors in this distribution and documentation
  201. to me. Thank you.
  202.  
  203. -orest
  204. orestz@eskimo.com
  205.